package web.suzy.oj.service.admin.user;

import com.baomidou.mybatisplus.core.metadata.IPage;
import web.suzy.oj.common.result.ResultBean;
import web.suzy.oj.pojo.dto.AdminEditUserDTO;
import web.suzy.oj.pojo.vo.SysUserRoleVO;

import java.util.List;
import java.util.Map;

/**
 * YangSuzy 软件工作室
 * 类名: AdminUserService
 * 描述: ---- 待定 -----
 * 功能: ---- 待定 -----
 *
 * @author YangSuzy
 * Date: 2022/11/17 19:08
 */
public interface AdminUserService {
    /**
     * 方法名: getUserList
     * 描述: 根据关键字分页查询用户列表
     *
     * @param limit       每页显示数量
     * @param currentPage 当前页
     * @param onlyAdmin   是否只查管理员
     * @param keyword     关键字
     * @return web.suzy.oj.common.result.ResultBean<com.baomidou.mybatisplus.core.metadata.IPage < web.suzy.oj.pojo.vo.SysUserRoleVO>>
     * @date 2022/11/17 19:08
     * @auther YangSuzy
     **/
    ResultBean<IPage<SysUserRoleVO>> getUserList(Integer limit, Integer currentPage, Boolean onlyAdmin, String keyword);

    /**
     * 方法名: deleteUser
     * 描述: 批量删除用户
     *
     * @param deleteUserIdList 待删除用户ID列表
     * @return web.suzy.oj.common.result.ResultBean<java.lang.Void>
     * @date 2022/11/17 21:43
     * @auther YangSuzy
     **/
    ResultBean<Void> deleteUser(List<String> deleteUserIdList);

    /**
     * 方法名: editUser
     * 描述: 管理员修改用户信息
     *
     * @param adminEditUserDto 修改用户信息数据传输对象
     * @return web.suzy.oj.common.result.ResultBean<java.lang.Void>
     * @date 2022/11/27 18:32
     * @auther YangSuzy
     **/
    ResultBean<Void> editUser(AdminEditUserDTO adminEditUserDto);

    /**
     * 方法名: generateUser
     * 描述: 快速生成用户
     *
     * @param params 用户数据参数
     * @return web.suzy.oj.common.result.ResultBean<java.util.Map < java.lang.Object, java.lang.Object>>
     * @date 2022/11/27 17:05
     * @auther YangSuzy
     **/
    ResultBean<Map<Object, Object>> generateUser(Map<String, Object> params);

    /**
     * 方法名: insertBatchUser
     * 描述: 通过CSV文件批量导入用户
     *
     * @param users 用户信息列表
     * @return web.suzy.oj.common.result.ResultBean<java.lang.Void>
     * @date 2022/11/27 19:05
     * @auther YangSuzy
     **/
    ResultBean<Void> insertBatchUser(List<List<String>> users);
}
